home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / forth / cforthu.arc / READ.ME < prev   
Text File  |  1985-07-11  |  4KB  |  94 lines
  1.  
  2. This is posting one of three of a portable FORTH interpreter, written
  3. entirely in C.  It has been successfully ported to a VAX 11/60 running
  4. BSD 2.9, to EUNICE version 3 (I think), and the original machine, a VAX
  5. 11/780 running BSD 4.2.  When I mentioned in net.lang.forth (and elsewhere)
  6. that I was writing this portable FORTH, several people asked that I post
  7. the results of my labors. Well, here they are.
  8.  
  9.                     -- Allan Pratt
  10.             (after May 7:) APRATT.PA@XEROX.ARPA
  11.  
  12.             [moderator's note:  I have had no luck at all getting through
  13.          to this address.  There was a missing file in the original
  14.              distribution "forth.lex.h" which I have reconstructed
  15.              (hopefully correctly).                    - John P. Nelson]
  16.  
  17.  
  18. [In order to move these files to an MS-DOS environment several file
  19.  names had to be changed.  If you are running under UNIX please
  20.  changes the following file names:
  21.  
  22.     forth.dic    to    forth.dict
  23.     forth_lx.h    to    forth.lex.h
  24.     forth.lin    to    forth.line
  25.     lex_yy.c    to    lex.yy.c
  26.  
  27.  I haven't tried to modify this to run under MS-DOS, however, the
  28.  code looks fairly portable (with the exception of file names).
  29.                             - Ken Brown ]
  30.  
  31.  
  32. QUICK SUMMARY OF FILES (THERE IS A MESS OF THEM!)
  33.  
  34. Makefile    supposed to bring them all together
  35. b2l.c and b2l*    filter to convert block-files into line-files for editing
  36. l2b.c and l2b*    filter to convert line-files into block-files for FORTH
  37.  
  38. common.h    This is a header file with configuration and common information
  39.         used by all C source files except lex.yy.c
  40.  
  41. forth.h        Header file with primitive numbers in it, among other things
  42. forth.c        source code for the guts/support functions for the interpreter
  43. prims.h        Header file with macro definitions for primitives
  44. prims.c        source code for primitives too complex for macros
  45.  
  46.         The above four files, plus common.h, contribute to the
  47.         executable "forth"
  48.  
  49. nf.c        source for the bootstrapper, which interprets the dictionary
  50.         and generates an initial memory image for FORTH
  51.  
  52. forth.lex    lex input for lexical analyzer used by nf.c
  53. forth.lex.h    header file used by lex.yy.c and nf.c
  54. (forth_lx.h)
  55.  
  56. lex.yy.c    lex output, modified (look at the Makefile)
  57. (lex_yy.c)
  58.  
  59.         The above four files, plus common.h, contribute to the
  60.         executable "nf", the preprocessor.
  61.  
  62. forth.block*    This is the (default) block-file used by FORTH for its
  63.         editing- and load-screens
  64.  
  65. forth.line    This file usually resembles forth.block, but is in a
  66. (forth.lin)    format suitable for editing with emacs or vi: a header
  67.         line, followed by sixteen lines of trailing-blank-
  68.         truncated, newline-terminated text for each screen.
  69.  
  70.         If one of forth.line and forth.block is out of date with
  71.         respect to the other, you can bring it back up to date
  72.         with b2l or l2b, above.
  73.  
  74. forth.dict    This is a human-readable, pseudo-FORTH dictionary which
  75. (forth.dic)    nf uses to generate the initial environment. It contains
  76.         forward references and no higher structures like DO..LOOP
  77.  
  78. forth.core*    This is one output of nf: it contains the core image for
  79.         the FORTH environment, as dictated by common.h and forth.dict
  80.  
  81. forth.newcore*    This is the file for holding core images saved with the (SAVE)
  82.         primitive. If FORTH is started with "-c forth.newcore", the
  83.         image is restarted right where it left off.
  84.  
  85. forth.map*    This is another output of nf: it contains a human-readable
  86.         dump of the forth environment which nf generated. This can
  87.         be compared with the post-mortem dump which FORTH generates
  88.         in forth.dump in certain cases.
  89.  
  90.  
  91. [Files marked with an '*' are not included - they are created as
  92.  the system is installed.  Names in parentheses are the names in
  93.  this library.   - Ken]
  94.